Skip to content

fix(ui5-split-button): announce accessible name before instructions - #13901

Merged
vladitasev merged 11 commits into
mainfrom
split_button_annonce_order
Sep 3, 2026
Merged

fix(ui5-split-button): announce accessible name before instructions#13901
vladitasev merged 11 commits into
mainfrom
split_button_annonce_order

Conversation

@Todor-ads

@Todor-ads Todor-ads commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Screen readers were announcing the keyboard usage instructions before the accessible name of the button, because keyboardHint was placed before accessibleName in the invisibleText span.

The fix swaps their order so the accessible name is announced immediately after the button label, followed by the instructions.

Fixes: #13841

@Todor-ads
Todor-ads requested a review from GDamyanov August 10, 2026 06:17
@Todor-ads
Todor-ads requested a review from unazko August 10, 2026 06:17
@sap-ui5-webcomponents-release

Copy link
Copy Markdown

@unazko unazko left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The custom role "Split Button" is not getting announced in JAWS. With NVDA it gets announced at the end and it should be announced after the accessible name announcement (the same as in openui5 split button).

In order to fix this custom role announcement inconsistency we should move the "Split Button" text from aria-roldescription attribute to the aria-label attribute instead (placing the custom role text directly after the accessible name).

@Todor-ads
Todor-ads requested a review from unazko August 13, 2026 12:21
Comment thread packages/main/src/SplitButton.ts
@Todor-ads
Todor-ads force-pushed the split_button_annonce_order branch from 9e86420 to ae867ef Compare August 14, 2026 10:53
@Todor-ads
Todor-ads requested a review from unazko August 14, 2026 10:56
unazko
unazko previously approved these changes Aug 14, 2026
@Todor-ads
Todor-ads requested a review from unazko August 17, 2026 11:53
Comment thread packages/main/src/SplitButton.ts
Comment thread packages/ai/src/Button.ts Outdated
Comment thread packages/ai/src/Button.ts Outdated
@Todor-ads
Todor-ads requested a review from GDamyanov September 2, 2026 06:23
@vladitasev
vladitasev dismissed GDamyanov’s stale review September 3, 2026 06:30

he's on vacation

@vladitasev
vladitasev merged commit 36f505f into main Sep 3, 2026
20 of 21 checks passed
@vladitasev
vladitasev deleted the split_button_annonce_order branch September 3, 2026 06:55
@sap-ui5-webcomponents-release

Copy link
Copy Markdown

🧹 Preview deployment cleaned up: https://pr-13901--ui5-webcomponents.netlify.app

@sap-ui5-webcomponents-release

Copy link
Copy Markdown

🎉 This PR is included in version v2.27.0-rc.1 🎉

The release is available on v2.27.0-rc.1

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[ui5-split-button]: buttons announce instructions before accessible name (WCAG 2.5.3 Label in Name)

5 participants